###Function###
WinActivate

###Description###
Holt ein bestimmtes Fenster in den Vordergrund und setzt den Fokus auf dasselbe.

###Syntax###
WinActivate ( "title" [, "text"] )


###Parameters###
@@ParamTable@@
title
	Der Titel, das Handle oder die Klasse des Fensters, welches in den Vordergrund gebracht werden soll. Hier: <a href="../intro/windowsadvanced.htm">Erweiterte Fenstertiteldefinition</a>.
text
	[optional] Der Text des Fensters, welches in den Vordergrund gebracht werden soll. Standardwert ist ein Leerstring. Siehe <a href="../intro/windowsbasic.htm#specialtext">Erweiterte Fenstertextdefinition</a>.
@@End@@

###ReturnValue###
@@ReturnTable@@
Erfolg:	das Handle des Fensters.
Fehler:	0, wenn das Fenster nicht gefunden wurde oder nicht aktiviert werden konnte. 
@@End@@


###Remarks###
Mit der <a href="WinActive.htm">WinActive()</a>-Funktion kann geprft werden, ob <a href="WinActivate.htm">WinActivate()</a> erfolgreich war. Falls mehrere Fenster die Kriterien erfllen, wird das zuletzt aktive Fenster aktiviert. <a href="WinActivate.htm">WinActivate()</a> funktioniert auch mit minimierten Fenstern. Trotzdem kann ein Fenster, welches den Status "immer im Vordergrund" hat, das aktivierte Fenster berlappen bzw. berdecken.

Nach einer erfolgreichen Aktivierung wird @extended auf 1 gesetzt, wenn das Fenster bereits aktiv war, ansonsten auf 2.

###Related###
WinClose, WinSetState, WinTitleMatchMode (Option), WinKill, WinMove


###Example###
@@IncludeExample@@
